﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <title>Usando JDBC Driver</title>
    
    <link rel="stylesheet" type="text/css" href="../local/Classic.css">
      
    </link>
    
    <script src="../local/script.js">
      
    </script><script src="../local/script_main.js">&amp;nbsp;</script>
  </head>
  <body>
    <!--Topic built:04/01/2010 05:03:30-->

    
    
    
    
    
    
    
    
    
    <div id="header">
      <table width="100%" id="topTable"><tr>
          <td align="left">
            <span id="headerBold">Usando JDBC Driver</span>
          </td>
          <td align="right">
            
          </td>
        </tr></table>
      
      
      
    </div>
    <div id="mainSection">
      
        
        
    <font color="DarkGray">
      
    </font>
    <p />
    
    <p />
  
        <div id="introductionSection" class="section">
    <p>Esta seção fornece instruções de início rápido para fazer uma conexão simples com um banco de dados do SQL Server usando o Microsoft SQL Server JDBC Driver. Antes de você se conectar a um banco de dados do SQL Server, o SQL Server deve ser instalado no computador local ou em um servidor e o JDBC Driver deve ser instalado no computador local. </p>
  </div><h1 class="heading">Escolhendo o arquivo JAR correto</h1><div id="sectionSection0" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">O Microsoft SQL Server JDBC Driver fornece os arquivos de biblioteca de classes <b>sqljdbc.jar</b> e <b>sqljdbc4.jar</b> a serem usados de acordo com as suas configurações preferenciais do JRE (Java Runtime Environment). Para obter mais informações sobre qual arquivo JAR escolher, consulte <a href="447792bb-f39b-49b4-9fd0-1ef4154c74ab.htm">Requisitos de sistema para o JDBC Driver</a>.</p>
    </content></div><h1 class="heading">Definindo o classpath</h1><div id="sectionSection1" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">A driver JDBC não faz parte do Java SDK. Se você quiser usá-lo, é necessário definir o classpath para incluir o arquivo sqljdbc.jar ou o arquivo sqljdbc4.jar. Se no classpath faltar uma entrada para sqljdbc.jar ou sqljdbc4.jar, o seu aplicativo lançará a exceção comum "Class not found".</p>
      <p xmlns="">Os arquivos sqljdbc.jar e sqljdbc4.jar são instalados no seguinte local:</p>
      <p xmlns="">&lt;<i>diretório de instalação</i>&gt;\sqljdbc_&lt;<i>versão</i>&gt;\&lt;<i>idioma</i>&gt;\sqljdbc.jar</p>
      <p xmlns="">&lt;<i>diretório de instalação</i>&gt;\sqljdbc_&lt;<i>versão</i>&gt;\&lt;<i>idioma</i>&gt;\sqljdbc4.jar</p>
      <p xmlns="">A seguir, veja um exemplo da instrução CLASSPATH que é usada para um aplicativo do Windows:</p>
      <p xmlns="">
        <code>CLASSPATH =.;C:\Program Files\Microsoft SQL Server JDBC Driver\sqljdbc_3.0\enu\sqljdbc.jar</code>
      </p>
      <p xmlns="">A seguir, veja um exemplo da instrução CLASSPATH que é usada para um aplicativo do Unix/Linux:</p>
      <p xmlns="">
        <code>CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_3.0/enu/sqljdbc.jar</code>
      </p>
      <p xmlns="">Você deve ter certeza de que a instrução CLASSPATH contém apenas um driver JDBC de Microsoft SQL Server, como, por exemplo, sqljdbc.jar ou sqljdbc4.jar.</p>
      <div style="margin: .5em 1.5em .5em 1.5em" xmlns=""><b>Observação: </b>
        Em sistemas Windows, nomes de diretórios mais longos que 8.3 ou nomes de pastas com espaços podem causar problemas com classpaths. Se você suspeitar destes tipos de problemas, mova temporariamente o arquivo sqljdbc.jar ou o arquivo sqljdbc4.jar para um diretório de nome simples como<code> C:\Temp</code>, altere o classpath e verifique se isso resolve o problema.<p />
      </div>
    </content><sections xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <h1 class="heading" xmlns="">Aplicativos que são executados diretamente no prompt de comando</h1><div id="sectionSection" class="section" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
          <p xmlns="">O classpath é configurado no sistema operacional. Acrescente sqljdbc.jar ou sqljdbc4.jar ao classpath do sistema. Como alternativa, você pode especificar o classpath na linha de comando do Java que executa o aplicativo usando a opção<code> java -classpath </code>.</p>
        </content></div>
      <h1 class="heading" xmlns="">Aplicativos que executam em um IDE</h1><div id="sectionSection" class="section" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
          <p xmlns="">Cada fornecedor de IDE oferece um método diferente para definir o classpath em seu IDE. Apenas definir o classpath no sistema operacional não funcionará. Você deve acrescentar sqljdbc.jar ou sqljdbc4.jar ao classpath do IDE.</p>
        </content></div>
      <h1 class="heading" xmlns="">Servlets e JSPs</h1><div id="sectionSection" class="section" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
          <p xmlns="">Servlets e JSPs são executados em um mecanismo de servlet/JSP como, por exemplo, Tomcat. O classpath deve ser definido de acordo com a documentação de mecanismo de servlet/JSP. Apenas definir o classpath no sistema operacional não funcionará. Alguns mecanismos de servlet/JSP fornecem telas de instalação que você pode usar para definir o classpath do mecanismo. Nessa situação, você deve acrescentar o arquivo JAR correto do JDBC Driver ao classpath de mecanismo existente e deve reiniciar o mecanismo. Em outras situações, você pode implantar o driver copiando sqljdbc.jar ou sqljdbc4.jar em um diretório específico, por exemplo, lib, durante a instalação do mecanismo. O classpath do driver de mecanismo também pode ser especificado em um arquivo de configuração específico do mecanismo.</p>
        </content></div>
      <h1 class="heading" xmlns="">Enterprise Java Beans</h1><div id="sectionSection" class="section" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
          <p xmlns="">Enterprise Java Beans (EJB) são executados em um contêiner EJB. Contêineres EJB são originados de vários fornecedores. Miniaplicativos Java são executados em um navegador, mas são baixados de um servidor Web. Copie sqljdbc.jar ou sqljdbc4.jar para a raiz do servidor Web e especifique o nome do arquivo JAR no parâmetro HTML archive da tag do miniaplicativo, por exemplo, <code>&lt;applet ... archive=sqljdbc.jar&gt;</code>.</p>
        </content></div>
    </sections></div><h1 class="heading">Fazendo uma conexão simples com um banco de dados</h1><div id="sectionSection2" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <p xmlns="">Usando a biblioteca de classes sqljdbc.jar, os aplicativos devem primeiro registrar o driver como segue:</p>
      <p xmlns="">
        <code>Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");</code>
      </p>
      <p xmlns="">Quando o driver é carregado, você pode estabelecer uma conexão usando uma URL de conexão e o método <b>getConnection</b> da classe <b>DriverManager</b>:</p>
      <div class="sampleCode" xmlns=""><span codeLanguage="other"><pre>String connectionUrl = "jdbc:sqlserver://localhost:1433;" +
   "databaseName=AdventureWorks;user=MyUserName;password=*****;";
Connection con = DriverManager.getConnection(connectionUrl);</pre></span></div>
      <p xmlns="">Na API do JDBC 4.0, o método <b>DriverManager.getConnection</b> é aprimorado para carregar drivers de JDBC automaticamente. Portanto, aplicativos não precisam chamar o método <b>Class.forName</b> para registrar ou carregar o driver ao usar a biblioteca de classes sqljdbc4.jar.</p>
      <p xmlns="">Quando o método <b>getConnection</b> da classe <b>DriverManager</b> é chamado, um driver apropriado é localizado no conjunto de drivers JDBC registrados. O arquivo sqljdbc4.jar inclui o arquivo "META-INF/services/java.sql.Driver", que contém <b>com.microsoft.sqlserver.jdbc.SQLServerDriver</b> como um driver registrado. Os aplicativos existentes, que atualmente carregam os drivers usando o método <b>Class.forName</b> continuarão funcionando sem modificação.</p>
      <div style="margin: .5em 1.5em .5em 1.5em" xmlns=""><b>Observação: </b>
        A biblioteca de classes sqljdbc4.jar requer um JRE (Java Runtime Environment) de versão 6.0 ou posterior.<p />
      </div>
      <p xmlns="">Para obter mais informações sobre como conectar-se com fontes de dados e usar uma URL de conexão, consulte <a href="44996746-d373-4f59-9863-a8a20bb8024a.htm">Construindo a URL de conexão</a> e <a href="f1b62700-f046-488d-bd6b-a5cd8fc345b7.htm">Definindo as propriedades de conexão</a>.</p>
    </content></div><span id="seeAlsoSpan"><h1 class="heading">Consulte também</h1></span><div id="seeAlsoSection" class="section" name="collapseableSection"><a href="939a8773-2583-49a4-bf00-6b892fbe39dc.htm">Visão geral do JDBC Driver</a><br /><br /></div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]-->
      <div id="footer" class="section">
        
		<hr />
		
		<span id="fb" class="feedbackcss">
			
			
		</span>
		
		<a href="9bad553b-9e70-4696-8499-2e35f772a1e0.htm">
			
			© 2010 Microsoft Corporation. Todos os direitos reservados.
		</a>
 	
	
      </div>
    </div>
  </body>
</html>